home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / pmqwk006.zip / PMQWK.HLP (.txt) < prev    next >
OS/2 Help File  |  1993-01-04  |  60KB  |  1,362 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Bug Reports/Feature Requests ΓòÉΓòÉΓòÉ
  3.  
  4. Bug reports and/or feature requests may be made to one of two people, in one of 
  5. several ways. 
  6.  
  7.  Please contact Brady Flowers at Oberon Software or Kimberly Bobrow. 
  8.  
  9.  
  10. ΓòÉΓòÉΓòÉ 2. Oberon Software ΓòÉΓòÉΓòÉ
  11.  
  12. Oberon Software has been involved in the creation of OS/2 related products and 
  13. services since 1988.  Founded by Brady Flowers, Oberon Software (named for the 
  14. wood sprite in Shakespeare's "A Mid-Summer Night's Dream") is committed to 
  15. enhancing the software base for the ever growing community of OS/2 users and to 
  16. helping foster the growth and acceptance of OS/2 as the next generation in 
  17. operating systems for personal computers and workstations. 
  18.  
  19. Oberon products are generally marketed as shareware to keep marketing overhead 
  20. to a minimum.  The savings can then be devoted to further development and 
  21. enhancements and customer service. Please, support the shareware concept by 
  22. registering the shareware products which you use and by passing them along to 
  23. others for their inspection. 
  24.  
  25. In addition to this program, Oberon Software offers the following products and 
  26. services: 
  27.  
  28. o Oberon Terminal Emulator/2 (TE/2) 
  29. o Oberon FSHL Command Line Executive 
  30. o Oberon LstPM file viewer 
  31. o Consulting Services and Custom Programming 
  32.  
  33. Several new products are planned for release in the near future. These will 
  34. include a programmer's Async Communications library/toolkit, enhancements to 
  35. all of our existing programs, and some new surprises. 
  36.  
  37.  
  38. ΓòÉΓòÉΓòÉ 2.1. Oberon Terminal Emulator/2 ΓòÉΓòÉΓòÉ
  39.  
  40. The Oberon Terminal Emulator/2, or TE/2, is Oberon Software's full featured, 
  41. easy to use, general purpose telecommunications program for OS/2. Developed 
  42. originally for OS/2 1.1, it was one the very first such programs written 
  43. specifically to take advantage of the power and capabilities of OS/2.  As OS/2 
  44. has grown, so has TE/2. It is now one of the most popular and widely 
  45. recommended telecommunications programs for OS/2! 
  46.  
  47. TE/2's features include: 
  48.  
  49. o One of the most complete script languages to be found in any telecomm program 
  50.   anywhere 
  51. o REXX/2 as a fully supported, optional script language 
  52. o Extensive facility for running external programs and protocols 
  53. o Multiple, 200 entry dialing directories 
  54. o Call logging 
  55. o Split screen chat mode 
  56. o 48 Assignable function keys 
  57. o Free technical support via the Oberon BBS! 
  58.  
  59. TE/2 includes these file transfer protocols: 
  60.  
  61. o XModem and XModem-1K 
  62. o YModem and YModem-G 
  63. o ZModem with automatic start-up and resume 
  64. o CompuServe(tm) B-Plus protocol 
  65. o Ascii file upload and capture 
  66.  
  67. Supported terminal emulations include: 
  68.  
  69. o Standard TTY (teletype) mode 
  70. o ANSI-BBS and enhanced ANSI 
  71. o VT100 (with VT102 and VT220 extensions) 
  72. o IBM 3101 
  73.  
  74. Call, write, or FAX Oberon Software for more information on TE/2. 
  75.  
  76.  
  77. ΓòÉΓòÉΓòÉ 2.2. Oberon FSHL Command Line Executive ΓòÉΓòÉΓòÉ
  78.  
  79. FSHL, \ef' shel\ n. [Flowers' shell, named for Brady Flowers, software designer 
  80. during the late 20th century]: a program which greatly enhances the power a 
  81. user has when working at the OS/2 command prompt by adding aliases and macros, 
  82. enhanced and extended command line recall and editing functions, extended 
  83. command set, enhanced batch language, and provisions for user-created 
  84. extensions. 
  85.  
  86. FSHL, Oberon Software's Alternative Command Line Executive for OS/2, layers 
  87. itself over the default OS/2 command line interpreter, CMD.EXE, to provide the 
  88. user with all of these extended services without sacrificing access to OS/2's 
  89. base level functionality! 
  90.  
  91. These are just some of the features of FSHL: 
  92.  
  93. o FSHL aliases allow the user to replace often typed, hard to type, or hard to 
  94.   remember commands with any other command of their preference. 
  95. o Full featured command line editor adds features to the OS/2 command prompt 
  96.   similar to those found in word processing programs. 
  97. o Recall previously typed commands: 
  98.  
  99.    - One at a time 
  100.    - By matching a partially typed command 
  101.    - By selection from a list 
  102.  
  103. o Extends the OS/2 batch language to allow access to FSHL's aliases and 
  104.   history. 
  105. o Dynamic pseudo environment variables to access system information such as the 
  106.   time and date, errorlevels, and window state. 
  107. o New built-in commands like: 
  108.  
  109.    - Sweep to execute a given command over an entire directory tree. 
  110.    - Window to control the OS/2 text mode window in which FSHL is running from 
  111.      the command line or a batch file. 
  112.    - Prty to adjust the OS/2 priority at which a program will run. 
  113.    - And lots more! 
  114.  
  115. o Extended options on existing OS/2 commands. 
  116. o All 48 function keys programmable as text macros. 
  117. o Two separate, powerful programming APIs allow third party developers to 
  118.   extend the basic FSHL command set and to allow applications to call back into 
  119.   FSHL to access its services. 
  120. o Free technical support via the Oberon BBS! 
  121.  
  122.  
  123. ΓòÉΓòÉΓòÉ 2.3. LstPM File Viewer ΓòÉΓòÉΓòÉ
  124.  
  125. LstPM is a 32 bit application which can be used for viewing just about any text 
  126. or data file on your system, either as text (ASCII or EBCDIC) or as a 
  127. hexadecimal "dump" representation. 
  128.  
  129. You can invoke LstPM by installing a WPS program object for it on your desktop 
  130. or in the folder of your choice and clicking on its icon, from the OS/2 command 
  131. line with an optional file name as parameter, or by dragging and dropping a 
  132. selected file or files onto its icon. 
  133.  
  134.  
  135. ΓòÉΓòÉΓòÉ 2.4. Consulting Services and Custom Programming ΓòÉΓòÉΓòÉ
  136.  
  137. Any of Oberon Software's products may be customized to meet your company's 
  138. specific needs.  Or, if you need something totally new, Oberon Software 
  139. specializes in the areas of: 
  140.  
  141. o Asynch/Telecommunications Software 
  142. o Interprocess Communications 
  143.  
  144.    - Network Environment 
  145.    - Standalone 
  146.  
  147. o Presentation Manager Based Software 
  148. o OS/2 Programmer and User Training 
  149. o Migrating D.O.S. applications to OS/2 
  150.  
  151. Please, contact Oberon Software for references and further information. 
  152.  
  153.  
  154. ΓòÉΓòÉΓòÉ 3. PmQwk Offline Mail Reader ΓòÉΓòÉΓòÉ
  155.  
  156. Welcome to Oberon Software's Offline mailreader for OS/2 2.0 Presentation 
  157. Manager! 
  158.  
  159. PmQwk is the first and only offline reader for OS/2's Presentation Manager 
  160. which allows you to truly multitask your offline reading.  You can read from 
  161. any number of conferences, from any number of BBSs simultaneously. 
  162.  
  163. You can have multiple replies, from any conference, from any BBS in progress at 
  164. any given time. 
  165.  
  166. There is support for netmail, taglines, regular expression searching, address 
  167. book, and much more! 
  168.  
  169. At last, an offline mail reader that is as good as the operating system it runs 
  170. on! 
  171.  
  172. For additional information, refer to the help for: 
  173.  
  174. o Installing PmQWk 
  175. o Starting PmQwk 
  176. o Help for BBS List 
  177.  
  178. You may also be interested in information regarding: 
  179.  
  180. o Registering PmQwk 
  181. o Oberon Software Products 
  182. o Copyright, License, and Warranty 
  183.  
  184.  
  185. ΓòÉΓòÉΓòÉ 3.1. Installing PmQwk ΓòÉΓòÉΓòÉ
  186.  
  187. There are three files which need to be installed on your harddisk for proper 
  188. operation of PmQwk: 
  189.  
  190.                 PMQWK.EXE
  191.                 PmQwk program executable file.  For best results, a dedicated 
  192.                 directory should be made for PmQwk.  We suggest that you make a 
  193.                 directory, on the disk of your choice, by the name PMQWK and 
  194.                 copy PMQWK.EXE and TagLines.txt into that directory.  You 
  195.                 should ensure that this directory is your current working 
  196.                 directory while you are running PmQwk as PmQwk will maintain 
  197.                 subdirectories for each bulletin board underneath this 
  198.                 directory. These files should be placed in a directory 
  199.                 specified in your PATH if you wish to run PmQwk from the 
  200.                 command line. 
  201.  
  202.                 REGEXPUT.DLL
  203.                 Regular Expression support library.  This must be placed in a 
  204.                 directory specified in your LIBPATH. 
  205.  
  206.                 PMQWK.HLP
  207.                 PmQwk help file.  This must be placed in a directory specified 
  208.                 by your HELP environment variable in order to have help active 
  209.                 while running PmQwk. 
  210.  
  211. Once PmQwk is installed on your hard disk, open the OS/2  Templates Folder, 
  212. select a Program Object Template with the left mouse button and then, using the 
  213. right mouse button, drag it onto the desktop or into the folder of your choice. 
  214. When the Settings Notebook appears, fill in the following: 
  215.  
  216. o Path and file name should be set to the full path/name to PMQWK.EXE (i.e., 
  217.   where you place the file in the step above). 
  218. o Parameters should be left blank - any parameters are ignored. 
  219. o Working directory should be the directory you placed PMQWK.EXE in. 
  220.  
  221. Click on the notebook tab labeled General and, on that page, set the Title to 
  222. PmQwk or a title of your preferance. 
  223.  
  224. See also First Time Startup 
  225.  
  226.  
  227. ΓòÉΓòÉΓòÉ 3.1.1. First Time Startup. ΓòÉΓòÉΓòÉ
  228.  
  229. You may start PmQwk from the OS/2 command line by first ensuring that the disk 
  230. and directory containing PmQwk are current and typing "PMQWK" at the system 
  231. prompt.  If you have installed PmQwk into your desktop setup (following the 
  232. rules for current directory) you may start it that way. 
  233.  
  234. Example batch file for starting PmQwk assuming that it is installed in to 
  235. directory 'D:\PMQWK': 
  236.  
  237.       @echo off
  238.       D:
  239.       CD \PMQWK
  240.       START /PM /N PMQWK
  241.  
  242.  Immediately upon entering PmQwk for the first time, select the menu item 
  243.  labeled Options and the submenu item labeled Paths 
  244.  
  245.  Select Save Options from the Options menu to make the changes permanent. 
  246.  
  247.  
  248. ΓòÉΓòÉΓòÉ 3.2. Starting PmQwk ΓòÉΓòÉΓòÉ
  249.  
  250. If you have created a program object, you may start PmQwk by simply clicking on 
  251. its icon. 
  252.  
  253. From the OS/2 command line, you may simply type "PMQWK". 
  254.  
  255. See also:  Installing PmQwk 
  256.  
  257.  
  258. ΓòÉΓòÉΓòÉ 3.3. Registering PmQwk ΓòÉΓòÉΓòÉ
  259.  
  260. You can register this wide beta version for $25.00 (US) and receive a free 
  261. upgrade when the release version comes out.  The release version will be $35.00 
  262. (US) 
  263.  
  264. Technical support is available through the Oberon Software bulletin board 
  265. system or by phone at no charge. 
  266.  
  267. A license is required for use of PmQwk by corporations and institutions, and 
  268. for its commercial distribution. 
  269.  
  270. You may obtain a license for the use of PmQwk by contacting Oberon Software. 
  271. The license is for perpetual, non-exclusive use of one version. 
  272.  
  273. Purchase orders and invoicing are acceptable. 
  274.  
  275. The fee for a license depends on the estimated number of copies of the program 
  276. that you will use.  The fee applies to one site.  For local area networks, one 
  277. copy must be licensed for each computer that will be using the program on the 
  278. network.  A discount schedule will be made available when the general release 
  279. is made. 
  280.  
  281.  
  282. ΓòÉΓòÉΓòÉ 3.4. Copyright, License, and Warranty ΓòÉΓòÉΓòÉ
  283.  
  284. This electronic document and the program files PMQWK.EXE, and PMQWK.HLP, ("the 
  285. software") are copyrighted by Oberon Software and the author, Brady Flowers. 
  286. The copyright owner hereby licenses you to use the software given these 
  287. restrictions: 
  288.  
  289.  o The program shall be supplied in its original, unmodified form, which 
  290.    includes this documentation; 
  291.  
  292.  o For-profit use without a license is prohibited; 
  293.  
  294.  o The program may not be included - or bundled - with other goods or services. 
  295.    Exceptions may be granted upon written request only. 
  296.  
  297.  o No fee is charged; an exception is granted to not for profit user's groups, 
  298.    which are permitted to charge a small fee (not to exceed $5) for materials, 
  299.    handling, postage, and general overhead.  No other organization is permitted 
  300.    to charge any amount for distribution of copies of the software or 
  301.    documentation, or to include copies of the software or documentation with 
  302.    sales of their own products. 
  303.  
  304.  The Regular Expression Engine provided in the dynamic link library 
  305.  REGEXPUT.DLL, used by PmQwk, is derived from previously copyrighted software. 
  306.  This is the copyright notice from the source code to that section of the 
  307.  software: 
  308.  
  309.  Copyright (c) 1986 by University of Toronto.  Written by Henry Spencer. Not 
  310.  derived from licensed software. 
  311.  
  312.  Permission is granted to anyone to use this software for any purpose on any 
  313.  computer system, and to redistribute it freely, subject to the following 
  314.  restrictions: 
  315.  
  316.   1. The author is not responsible for the consequences of use of this 
  317.      software, no matter how awful, even if they arise from defects in it. 
  318.  
  319.   2. The origin of this software must not be misrepresented, either by explicit 
  320.      claim or by omission. 
  321.  
  322.   3. Altered versions must be plainly marked as such, and must not be 
  323.      misrepresented as being the original software. 
  324.  
  325.  Slight alterations were made to Mr. Spencer's software in the process of 
  326.  porting it to the OS/2 environment.  Mr. Spencer's original source code is 
  327.  available to the public for download from the Oberon Software User Support 
  328.  BBS. 
  329.  
  330.  There is no warranty of any kind.  By using the software, you agree to this. 
  331.  
  332.  The software and documentation are: 
  333.  
  334.      Copyright (C) 1990-1992 by Oberon Software and Brady Flowers 
  335.      Mankato, MN, USA 
  336.  
  337.  
  338. ΓòÉΓòÉΓòÉ 4. Help for Keys ΓòÉΓòÉΓòÉ
  339.  
  340. The following information is available regarding PmQwk's keyboard interface: 
  341.  
  342.  o Menus 
  343.  o Dialog Boxes 
  344.  
  345.  
  346. ΓòÉΓòÉΓòÉ 4.1. Menu Item Selection ΓòÉΓòÉΓòÉ
  347.  
  348. You can select any item from the action bar menu by typing Alt-letter where 
  349. "letter" is the underlined letter in the menu item text.  For example, the File 
  350. menu item text has the letter "F"  underlined so it may be accessed by typing 
  351. Alt-F.  Alternately, you may activate the action bar by pressing and releasing 
  352. the Alt key or by pressing and releasing the the F10 key. Thereafter, you may 
  353. select an item by pressing the key corresponding to the underlined letter in 
  354. the menu item text or by moving the highlight to that item with the arrow keys 
  355. and pressing Enter when it is highlighting the desired item. 
  356.  
  357. When a pulldown menu or a submenu is visible, you may select an item from these 
  358. menus by pressing the underlined letter key (the Alt key is optional in this 
  359. case) or by moving the highlight with the arrow keys and pressing Enter. 
  360.  
  361. The System Menu (the icon with the mini icon in the upper left corner of the 
  362. window frame) may be activated from the keyboard by pressing Alt-SpaceBar. 
  363.  
  364. You may exit any menu without making a selection by pressing the ESC key. 
  365.  
  366. Some menu items have an associated accelerator key associated with them.  For 
  367. example, Alt-F4 is associated with the Close item on the System menu.  These 
  368. accelerator keys are always available whenever PmQwk's main window or its 
  369. action bar has the focus. 
  370.  
  371.  
  372. ΓòÉΓòÉΓòÉ 4.2. Dialog Boxes ΓòÉΓòÉΓòÉ
  373.  
  374. Dialog boxes are usually divided into groups of controls (buttons, entry 
  375. fields, list boxes, etc.).  The TAB key will move the highlight from control to 
  376. control regardless of group boundaries;  Shift+TAB will do the same in the 
  377. reverse direction.  The Arrow Keys will move the highlight from control to 
  378. control always staying within the current group of controls. 
  379.  
  380. Buttons are selected by moving the highlight to the desired button and pressing 
  381. the SpaceBar or, if the button's text contains an underlined letter, by 
  382. pressing Alt+letter (see also the discussion on accelerator keys in the help 
  383. for menus 
  384.  
  385. Usually a dialog box will have one button with a special highlight. This is the 
  386. default button which is invoked by pressing Enter. If the dialog has a button 
  387. labeled Cancel, this button may be invoked by pressing the ESC key. 
  388.  
  389. Some controls have special rules for keystrokes: 
  390.  
  391.  o Entry fields are not exited via the TAB key.  To exit an entry field, press 
  392.    Enter (the default button will not be invoked). 
  393.  
  394.  o When a List Box has the highlight, the arrow keys will move the highlight 
  395.    within the list box up and down (or scroll the list box left and right if it 
  396.    has a horizontal scroll bar).  Exit a List Box using the TAB key. 
  397.  
  398.  o Spin Buttons and Combo Boxes behave analogously to List Boxes. 
  399.  
  400.  o Select or deselect a Check Box by pressing the SpaceBar while the Check Box 
  401.    has the highlight. 
  402.  
  403.  o Move the selection within a group of Radio Buttons using the Arrow Keys. 
  404.  
  405.  
  406. ΓòÉΓòÉΓòÉ <hidden> Menu Help for File Menu ΓòÉΓòÉΓòÉ
  407.  
  408. Pack, unpack and address book choices available here. 
  409.  
  410.  
  411. ΓòÉΓòÉΓòÉ <hidden> Menu Help for Unpack QWK Packet ΓòÉΓòÉΓòÉ
  412.  
  413. This selection will bring you to the Unpack QWK Packet 
  414.  
  415. Related Information: 
  416.  
  417.  Unpacking packets 
  418.  Setting Paths 
  419.  Packing Replies 
  420.  Setting Unpacking Software 
  421.  
  422.  
  423. ΓòÉΓòÉΓòÉ <hidden> Menu Help for Pack Replies ΓòÉΓòÉΓòÉ
  424.  
  425. This selection will bring you to the Pack Replies dialog which will allow you 
  426. to pack replies for one or more BBSs. 
  427.  
  428. Related Information: 
  429.  
  430.  Packing Replies 
  431.  Setting Paths 
  432.  Unpacking packets 
  433.  Setting Packing Software 
  434.  
  435.  
  436. ΓòÉΓòÉΓòÉ <hidden> Menu Help for Address Book ΓòÉΓòÉΓòÉ
  437.  
  438. Opens up the PmQwk Address Book. 
  439.  
  440. Related Information:  Address Book 
  441.  
  442.  
  443. ΓòÉΓòÉΓòÉ <hidden> Menu Help for Exit ΓòÉΓòÉΓòÉ
  444.  
  445. Exit PmQwk 
  446.  
  447.  
  448. ΓòÉΓòÉΓòÉ <hidden> Menu Help for Options ΓòÉΓòÉΓòÉ
  449.  
  450. Fonts, Colors, Paths, Preferences, and Editors can be selected from here. 
  451.  
  452. Related Information: 
  453.  
  454.  Setting Fonts 
  455.  Setting Colors 
  456.  Setting Paths 
  457.  Setting Preferences 
  458.  Selelcting an Editor 
  459.  
  460.  
  461. ΓòÉΓòÉΓòÉ <hidden> Menu Help for Fonts ΓòÉΓòÉΓòÉ
  462.  
  463. Choose fonts for listboxes and text areas. 
  464.  
  465. Related Information:  Setting Fonts 
  466.  
  467.  
  468. ΓòÉΓòÉΓòÉ <hidden> Menu Help for Colors ΓòÉΓòÉΓòÉ
  469.  
  470. Choose colors for listboxes and text areas. 
  471.  
  472. Related Information:  Setting Colors 
  473.  
  474.  
  475. ΓòÉΓòÉΓòÉ <hidden> Menu Help for Paths ΓòÉΓòÉΓòÉ
  476.  
  477. Select paths for packers and unpackers. 
  478.  
  479. Related information: 
  480.  
  481.  Setting Paths 
  482.  Unpacking QWK Packets 
  483.  Packing Replies 
  484.  
  485.  
  486. ΓòÉΓòÉΓòÉ <hidden> Menu Help for Editors ΓòÉΓòÉΓòÉ
  487.  
  488. Select an editor for replies. 
  489.  
  490. Related information:  Setting the editor 
  491.  
  492.  
  493. ΓòÉΓòÉΓòÉ <hidden> Menu Help for Preferences ΓòÉΓòÉΓòÉ
  494.  
  495. Set various preferences: 
  496.  
  497.  Beep on personal messages 
  498.  Show only active conferences 
  499.  Quote attribution text 
  500.  Wrap column 
  501.  Prepend/Strip "Re:" from subject lines 
  502.  Prev/Next button position 
  503.  Use Taglines 
  504.  Use Cutline 
  505.  
  506.  Related information:  Selecting preferences 
  507.  
  508.  
  509. ΓòÉΓòÉΓòÉ <hidden> Menu Help for Save Options ΓòÉΓòÉΓòÉ
  510.  
  511. Save PmQwk options and preferences. 
  512.  
  513.  
  514. ΓòÉΓòÉΓòÉ <hidden> Menu Help for Help Menu ΓòÉΓòÉΓòÉ
  515.  
  516. Various help for PmQwk Offline Reader. 
  517.  
  518.  
  519. ΓòÉΓòÉΓòÉ <hidden> Menu Help for Using Help ΓòÉΓòÉΓòÉ
  520.  
  521. Help for the help system. 
  522.  
  523.  
  524. ΓòÉΓòÉΓòÉ <hidden> Menu Help for General Help ΓòÉΓòÉΓòÉ
  525.  
  526. General help for PmQwk. 
  527.  
  528.  
  529. ΓòÉΓòÉΓòÉ <hidden> Menu Help for Key Help ΓòÉΓòÉΓòÉ
  530.  
  531. Help for keyboard keys in PmQwk. 
  532.  
  533.  
  534. ΓòÉΓòÉΓòÉ <hidden> Menu Help for Help Index ΓòÉΓòÉΓòÉ
  535.  
  536. Help index. 
  537.  
  538.  
  539. ΓòÉΓòÉΓòÉ <hidden> Menu Help for Product Information ΓòÉΓòÉΓòÉ
  540.  
  541. Information about the current version of PmQwk. 
  542.  
  543.  
  544. ΓòÉΓòÉΓòÉ 5. BBS List ΓòÉΓòÉΓòÉ
  545.  
  546. The BBS List displays all currently unpacked QWK packets.  To read from the 
  547. conferences in a particular BBS, select the BBS in the list box, and press the 
  548. Open button, or simply double-click on the BBS name in the list box. 
  549.  
  550. Related information: 
  551.  
  552.  Selecting a Conference to read from 
  553.  Deleting Open BBS Packets 
  554.  Packing Replies 
  555.  Unpacking QWK Packets 
  556.  
  557.  
  558. ΓòÉΓòÉΓòÉ 5.1. BBS Delete ΓòÉΓòÉΓòÉ
  559.  
  560. Choose Delete from the BBS List to delete the files from an open BBS 
  561. conference.  You will also have the option to delete the corresponding QWK 
  562. packet from your disk as well.  If there are unpacked replies, you will be 
  563. prompted to confirm their deletion. 
  564.  
  565. Related information:  Deleting QWK packets 
  566.  
  567.  
  568. ΓòÉΓòÉΓòÉ 6. Selecting a Conference ΓòÉΓòÉΓòÉ
  569.  
  570. To begin the process of reading messages, first select a BBS from the BBS List 
  571. window (if this list is empty, you must first unpack at least one QWK packet! 
  572. See Unpacking QWK packets). 
  573.  
  574. After selecting a BBS, another dialog will appear which will list the available 
  575. conferences for that BBS.  Conferences which contain messages will be indicated 
  576. with a '+' sign in this list while empty conferences will have a '-' as the 
  577. first character.  Each conference also has an indication, in parentheses, of 
  578. how many message are available and your "current position" in the list.  For 
  579. example: 
  580.  
  581. +4/Netmail (5/15)
  582.  
  583. indicates that area #4, called "Netmail" has messages, that it has fifteen 
  584. messages and that you will enter viewing the fifth message. 
  585.  
  586. Please note that, by default, areas which contain no messages (and would thus 
  587. have a '-' as the first character in their listing, are not shown at all.  To 
  588. enable their visibility, use the Preferences dialog and toggle the checkbox 
  589. labeled Show only active conferences to OFF. 
  590.  
  591. There is one extra, pseudo-conference which appears at the beginning of each 
  592. BBS's conference list named "Replies".  This is where all of your entered 
  593. messages and replies will be kept until they are packed for retransmission to 
  594. the BBS.  It behaves in most ways exactly like a "normal" message window. 
  595. However, the "Reply" and "Enter" functions are replaced with "Edit" and 
  596. "Delete".  "Edit" will allow you to reedit the message, possibly just the 
  597. "envelope" information or the entire message text, while "Delete" will erase 
  598. the currently viewed reply. 
  599.  
  600. If this is a netmail message, the Receiver's net address will appear in 
  601. parentheses after his/her name. 
  602.  
  603.  
  604. ΓòÉΓòÉΓòÉ 7. Reading Messages ΓòÉΓòÉΓòÉ
  605.  
  606. When you select a conference to view, you will be presented with a window which 
  607. contains a "message header" at the top of the window, a scrollable region in 
  608. the central area containing the message text, and a set of buttons at the 
  609. bottom of the window for initiating various activities. 
  610.  
  611. The "message header" contains the following information: the message number, 
  612. the number of the message it refers to (if any), the position in the list of 
  613. messages (e.g."#5 of 15"), the sender's name, the addressee's name, the subject 
  614. of the message, its time and date stamp, whether it is a private or public 
  615. message, and whether the bulletin board has marked this message as "Seen by 
  616. you" or not. If this is a net mail message, the sender's net address will be 
  617. given after his/her name in parentheses. 
  618.  
  619. Most of the activities are self-explanatory: Next and Prev will view the next 
  620. and previous message in the conference respectively, Quit closes the window, 
  621. Help invokes the help display. Reply and Enter will invoke the reply editor, 
  622. the difference being that Reply will preset much of the reply header 
  623. information with data from the current message while Enter will begin the 
  624. creation of a new, unrelated (as least as far as the QWK format is concerned) 
  625. message. 
  626.  
  627. Related Information: 
  628.  
  629.  o Listing messages 
  630.  o Copying messages 
  631.  
  632.  
  633. ΓòÉΓòÉΓòÉ 7.1. Replying to Messages ΓòÉΓòÉΓòÉ
  634.  
  635. To reply to a message, simply invoke the "reply" button while you are viewing 
  636. the message in question.  The message will be placed into a file in "quoted" 
  637. form and your editor will be invoked on that file.  You may edit any part of 
  638. this file and/or append to the file.  While your editor is in the process of 
  639. editing the reply, a new icon will appear in the main client window: the Active 
  640. Edit Sessions 
  641.  
  642. When you finish editing your reply, you will be returned to PmQwk and given the 
  643. opportunity to edit the "Envelope" information.  This will already have your 
  644. name, the receivers name, net address (if applicable), the conference for the 
  645. message, and the subject filled in.  You may edit any of these items except 
  646. your own name.  If TagLines are enabled (see Options) you may select a tagline 
  647. to use from this dialog. 
  648.  
  649. If you press "OK" and all of the required fields are filled in, the reply will 
  650. be saved.  If you press "Cancel" the message will be discarded after you 
  651. confirm that this is your desire. 
  652.  
  653. Should you need to reedit a reply message or delete a reply message, invoke the 
  654. "Replies" pseudo-confernce and perform the desired action from there (see 
  655. Selecting Conferences) 
  656.  
  657.  
  658. ΓòÉΓòÉΓòÉ 7.2. Help for Entering a New Message ΓòÉΓòÉΓòÉ
  659.  
  660. Sometimes you may wish to enter a message which is not a reply to any existing 
  661. message.  There are two ways to do this: via the "Enter" button while viewing a 
  662. conference, and via the "Message" button from the Conference List dialog.  In 
  663. both cases, the procedure that follows is almost exactly that of creating a 
  664. reply message with the following exceptions: 
  665.  
  666.  o The "Envelope" dialog will appear both before AND after you edit the 
  667.    message. 
  668.  o No default information is filled in in the "Envelope" dialog the first time; 
  669.    you must specify all fields. 
  670.  
  671.  Otherwise, for all intents and purposes, a message of this sort is treated 
  672.  exactly like any other reply. 
  673.  
  674.  
  675. ΓòÉΓòÉΓòÉ 7.2.1. Active Edit Sessions ΓòÉΓòÉΓòÉ
  676.  
  677. This is a list of all current invocations of the editor and a button which will 
  678. allow you immediately switch to any of the listed editor sessions. 
  679.  
  680.  
  681. ΓòÉΓòÉΓòÉ 7.3. Copying Messages ΓòÉΓòÉΓòÉ
  682.  
  683. You may mark areas within the message text using the mouse pointer and copy 
  684. them to the system clipboard using CONTROL+INSERT or you may use the "Copy" 
  685. dialog. 
  686.  
  687. This dialog allows you to refine how you export the data to a greater degree. 
  688. You may chose to copy the entire message or just the marked area (if any), you 
  689. may optionally include header information about the message in the export, and 
  690. you may copy it directly to a file or to the system clipboard. 
  691.  
  692. Related information:  Copying to file 
  693.  
  694.  
  695. ΓòÉΓòÉΓòÉ 7.3.1. Copying to File ΓòÉΓòÉΓòÉ
  696.  
  697. Selecting the Copy to file option from the Copy dialog will open up a standard 
  698. file dialog. 
  699.  
  700. Select a drive, directory, and either choose an existing file name from the 
  701. list box (to append or replace) or type the file name in the entry field. 
  702.  
  703.  
  704. ΓòÉΓòÉΓòÉ 7.4. Listing Messages ΓòÉΓòÉΓòÉ
  705.  
  706. This invokes a dialog window which, initially contains a list of all messages 
  707. in the area, their message number, subject, sender, receiver, and time/date. 
  708. Messages addressed to you are marked with an asterisk "*".  You may select a 
  709. message from this list and press the OK button to go immediately to that 
  710. message. 
  711.  
  712. The Filter button in this dialog allows you to view a subset of the messages in 
  713. the list.  You may search for text in "envelope"  fields (Sender, Receiver, and 
  714. Subject) or in the message body itself. 
  715.  
  716. The filtering is for purposes of the "List" dialog only, it does not affect the 
  717. behavior of the message window at all (except as regards jumping to a message). 
  718.  
  719.  
  720. ΓòÉΓòÉΓòÉ 7.4.1. Filtering Messages ΓòÉΓòÉΓòÉ
  721.  
  722. The message filter allows you to search through a conference for messages that 
  723. have specific characteristics.  You can search in one of four fields for text: 
  724.  
  725.  o Sender 
  726.  o Receiver 
  727.  o Subject 
  728.  o Message 
  729.  
  730.  There are two search styles: 
  731.  
  732.  o Case sensitive - which will ignore upper and lower case when selected. 
  733.  o Regular expression (double-click for more information.) 
  734.  
  735.  Press Search to obtain a list of messages which satisfy the search 
  736.  requirements.  You may then read any message just as you would from the 
  737.  regular List dialog. 
  738.  
  739.  The filtering is for purposes of the "List" dialog only, it does not affect 
  740.  the behavior of the message window at all (except as regards jumping to a 
  741.  message). 
  742.  
  743.  
  744. ΓòÉΓòÉΓòÉ 7.4.2. Regular Expression ΓòÉΓòÉΓòÉ
  745.  
  746. REGULAR EXPRESSION SYNTAX 
  747.  
  748. A regular expression is zero or more branches, separated by '|'.  It matches 
  749. anything that matches one of the branches. 
  750.  
  751. A branch is zero or more pieces, concatenated.  It matches a match for the 
  752. first, followed by a match for the second, etc. 
  753.  
  754. An atom is a regular expression in parentheses (matching a match for the 
  755. regular expression), a range (see below), '.' (matching any single character), 
  756. '^' (matching the null string at the beginning of the input string), '$' 
  757. (matching the null string at the end of the input string), a '\' followed by a 
  758. single character (matching that character), or a single character with no other 
  759. significance (matching that character). 
  760.  
  761. A piece is an atom possibly followed by '*', '+', or '?'. 
  762.  
  763.  o An atom followed by '*' matches a sequence of 0 or more matches of the atom. 
  764.  o An atom followed by '+' matches a sequence of 1 or more matches of the atom. 
  765.  o An atom followed by '?' matches a match of the atom, or the null string. 
  766.  
  767.  A range is a sequence of characters enclosed between square brackets '[' and 
  768.  ']'.  It normally matches any single character from the sequence.  If the 
  769.  sequence begins with '^',  it matches any single character not found in the 
  770.  rest of the sequence.  If two characters in the sequence are separated by '-', 
  771.  this is shorthand for the full list of ASCII characters between them (e.g. 
  772.  '[0-9]' matches any decimal digit).  To include a literal ']' in the sequence, 
  773.  make it the first character (following a possible '^').  To include a literal 
  774.  '-', make it the first or last character. 
  775.  
  776.  EXAMPLES 
  777.  
  778.       The regular expression: "go*d"
  779.       Would match any of: "gd", "god", "good", "gooooooood".
  780.  
  781.       The regular expression: "^[Dd]ear [A-Z]"
  782.       Would match the first six characters of "Dear John" or "dear Me"
  783.       if the string is found as the first thing on the line in which it occurs.
  784.  
  785.       The regular expression: "[^Dd]ear [A-Z]"
  786.       Would NOT match either "Dear John" or "dear Me" regardless of
  787.       where they occurred on the line.  It would match the first six
  788.       characters of either "Bear Country" or "Fear And Loathing" anywhere
  789.       on the line however.
  790.  
  791.       The regular expression:
  792.   "^[_a-zA-Z].*\(.*\)[ \t]*(/\*.*\*/[ \t]*)*$"
  793.  
  794.       Would match any "C" language function definition!  If you understand
  795.       this last example, however, please refer to the note regarding
  796.       C-style backslash notation
  797.  
  798.  AMBIGUITY 
  799.  
  800.  If a regular expression could match two different parts of the input string, 
  801.  it will match the one which begins earliest.  If both begin in the same place 
  802.  but match different lengths, or match the same length in different ways, life 
  803.  gets messier, as follows. 
  804.  
  805.  In general, the possibilities in a list of branches are considered in 
  806.  left-to-right order, the possibilities for '*', '+', and '?' are considered 
  807.  longest-first, nested constructs are considered from the outermost in, and 
  808.  concatenated constructs are considered leftmost-first.  The match that will be 
  809.  chosen is the one that uses the earliest possibility in the first choice that 
  810.  has to be made.  If there is more than one choice, the next will be made in 
  811.  the same manner (earliest possibility) subject to the decision on the first 
  812.  choice. And so forth. 
  813.  
  814.  For example, '(ab|a)b*c' could match 'abc' in one of two ways.  The first 
  815.  choice is between 'ab' and 'a'; since 'ab' is earlier, and does lead to a 
  816.  successful overall match, it is chosen.  Since the 'b' is already spoken for, 
  817.  the 'b*' must match its last possibility (the empty string) since it must 
  818.  respect the earlier choice. 
  819.  
  820.  In the particular case where no '|'s are present and there is only one '*', 
  821.  '+', or '?', the net effect is that the longest possible match will be chosen. 
  822.  So 'ab*', presented with 'xabbbby', will match 'abbbb'.  Note that if 'ab*' is 
  823.  tried against 'xabyabbbz', it will match 'ab' just after 'x', due to the 
  824.  begins-earliest rule.  (In effect, the decision on where to start the match is 
  825.  the first choice to be made, hence subsequent choices must respect it even if 
  826.  this leads them to less-preferred alternatives.) 
  827.  
  828.  
  829. ΓòÉΓòÉΓòÉ 8. Unpacking QWK Packets ΓòÉΓòÉΓòÉ
  830.  
  831. QWK packets from any number of BBSs may be unpacked simultaneously, although 
  832. only one packet from any one specific BBS may be opened at a time.  Future 
  833. releases of PmQwk will have the ability to combine packets from the same BBS. 
  834.  
  835. Make sure that any and all QWK packets in which you are interested are located 
  836. in the directory which you specified as your  InBound path.  Select "Unpack QWK 
  837. Packet" from the menu or press the "Unpack" button in the  BBS List dialog 
  838. window.  You will be presented with a list of valid QWK packets which PmQwk was 
  839. able to locate in your "InBound" directory.  Select one to unpack either by 
  840. double clicking on the file name and info or by selecting it and pressing the 
  841. "OK" button.  The packet will now be unpacked (if you are about to overwrite 
  842. another packet, you will be given to opportunity to abort the action).  Repeat 
  843. this procedure for every QWK packet you wish to unpack. 
  844.  
  845. If you have never unpacked a packet from this source before, a new item will 
  846. appear in the BBS List window at this point. 
  847.  
  848. Note:  The first time you start PmQwk with a valid InBound path, or the first 
  849. time you select "Unpack QWK Packet" with a valid InBound path, there may be 
  850. some delay as PmQwk scans the inbound directory for the first time.  This delay 
  851. will only be significant if there are many files matching the pattern "*.q*" in 
  852. that directory.  Only "new files" are scanned so the delay should not be 
  853. significant on subsequent invocations. 
  854.  
  855.  
  856. ΓòÉΓòÉΓòÉ 8.1. Deleting Qwk Packets ΓòÉΓòÉΓòÉ
  857.  
  858. You may delete QWK packets which are in your current  Inbound directory. 
  859.  
  860. Select "Unpack QWK Packet" from the menu or press the "Unpack" button in the 
  861. BBS List dialog window.  You will be presented with a list of valid QWK packets 
  862. which PmQwk was able to locate in your InBound directory.  Select one to delete 
  863. by clicking on the QWK packet and then pressing the Delete button.  You will be 
  864. prompted for confirmation before the packet is deleted. 
  865.  
  866.  
  867. ΓòÉΓòÉΓòÉ 9. Packing Replies ΓòÉΓòÉΓòÉ
  868.  
  869. Select Pack Replies from the menu or press the Pack button is the BBS List 
  870. dialog window. 
  871.  
  872. You will be presented with a list of all BBSs which have unpacked reply 
  873. messages defined.  Select one or more from this list and press "OK". 
  874.  
  875. For each selection from the previous list, you will be given a dialog wherein 
  876. you may select the archiver to use for packaging this reply packet and, if a 
  877. file by the target name already exists in your OutBound directory, the option 
  878. of overwriting that file or appending the new messages to it. 
  879.  
  880. There are possibly two buttons in this dialog labeled List Replies; one which 
  881. always appears and another which will only be present if there already exists a 
  882. reply packet in your  OutBound path.  This second button appears inside of a 
  883. group box labeled Existing Replies in this case.  The first of these buttons 
  884. will provide a list of Reply Headers (the conference number, receiver, and 
  885. subject) for each message in the group of new messages the second will do the 
  886. same for the existing replies.  Note, if the existing reply packet was not 
  887. created using PmQwk, PmQwk will not attempt to list its contents. 
  888.  
  889. The button labeled Change Path will invoke a dialog wherein you may override 
  890. the currently set OutBound path (or reset it to the default value if you have 
  891. changed it). 
  892.  
  893. Press the OK button to begin the packing process, press Cancel to abort the 
  894. process. 
  895.  
  896.  
  897. ΓòÉΓòÉΓòÉ 9.1. Changing Reply Paths ΓòÉΓòÉΓòÉ
  898.  
  899. Select the Change Path button from the  Save Packet dialog to change the path 
  900. for a single reply packet. 
  901.  
  902. Select Options and then Paths for a permanent outbound path change. 
  903.  
  904.  
  905. ΓòÉΓòÉΓòÉ 10. Address Book ΓòÉΓòÉΓòÉ
  906.  
  907. The address book feature of PmQwk is activated by choosing Address Book from 
  908. the Files menu in the main client window of PmQwk. 
  909.  
  910. This is a small database wherein you may keep an organized list of names, 
  911. netmail addresses, and notes for future reference. 
  912.  
  913. Each data record in the Address Book consists of four fields: a Search key, and 
  914. Name, and a Net Address, each of which may be up to 25 characters long plus a 
  915. Notes field which can hold up to 949 characters of information. 
  916.  
  917. The reason for having the Key field separate from the Name field is so that you 
  918. may enter the name as it is to appear in your reply envelopes (i.e., Name: 
  919. Barney Rubble or UUCP) and still have your list sorted by something other than 
  920. first name (i.e., Search Key: Rubble, Barney). 
  921.  
  922. There are five buttons in the Address Book window, each of which will initiate 
  923. an action.  Close will close the address book window, New will insert a new, 
  924. empty record and place the Address Book in edit mode for that record, Edit will 
  925. place the address book into edit mode for the currently viewed record, Delete 
  926. will delete the currently displayed record 
  927.  
  928. Note:  In the BETA release of the program, the user is NOT queried at this 
  929. point whether or not to really delete the record! 
  930.  
  931. By default, the Address Book comes up in 'lookup mode'.  You may view the 
  932. details for any entry by either selecting its key from the listbox at the left 
  933. of the window or by typing the first character or characters of the key into 
  934. the entry field labeled Search Key in the upper left of the window.  The latter 
  935. performs an 'incremental search' through the list of keys, that is, if you type 
  936. 'F', the listbox highlight moves to the first entry which begins with an 'F' 
  937. (this is not case sensitive), if you then proceed to type an 'L', the highlight 
  938. moves to the first entry in the listbox which begins with 'FL'. 
  939.  
  940. Related information: 
  941.  
  942.  o Adding Address Book Entries 
  943.  o Editing Address Book Entries 
  944.  o Copying information to the Envelope window 
  945.  
  946.  
  947. ΓòÉΓòÉΓòÉ 10.1. Adding/Editing Address Book Entries ΓòÉΓòÉΓòÉ
  948.  
  949. You enter 'edit mode' by pressing either the New button or the Edit button. 
  950. The New button inserts a new, blank record and allows you to edit that record; 
  951. the 'Edit' button is only available if a valid record is currently displayed 
  952. and it allows you to edit the currently viewed record. 
  953.  
  954. In 'edit mode', the listbox is replaced with a short, informational message and 
  955. all four of the entry fields (Search key, Name, Net Addr, and Notes) will now 
  956. accept input.  You may type anything into these fields you wish; you may use 
  957. all of the standard OS/2 editing keys and clipboard functions (i.e., 
  958. Shift+Delete, Ctrl+Insert, and Shift+Insert for Cut, Copy, and Paste). To save 
  959. the record as edited, press the Save button, to cancel changes press the Cancel 
  960. button 
  961.  
  962. If you have edited the 'Search Key', the listbox in the 'view mode' window will 
  963. be rearranged as needed. 
  964.  
  965.  
  966. ΓòÉΓòÉΓòÉ 10.2. Addressing envelopes from the Address Book ΓòÉΓòÉΓòÉ
  967.  
  968. The OS/2 editing keys which allow you to access the system clipboard are 
  969. active, that is, you may 'Mark' the name in the Address Book with the mouse or 
  970. the keyboard, copy it to the clipboard (Ctrl+Insert) and paste it into any OS/2 
  971. application which will accept clipboard data.  This, of course, includes the 
  972. the fields in PMQWK's Envelope windows.  For direct communication with the 
  973. Envelope window, however, you may elect to use the built-in "Drag and Drop" 
  974. interface. 
  975.  
  976. If you press and hold Mouse Button Two (usually the right mouse button) while 
  977. the mouse pointer is over the 'Name" field or field label in the Address Book 
  978. window, the mouse pointer will change into a small rectangle with the word NAME 
  979. in it.  Still holding mouse button two, move the mouse pointer to the Envelope 
  980. window in which you wish this name to appear until the superimposed circle with 
  981. a slash disappears and release the mouse button.  The name will replace 
  982. whatever text is currently in the To: field in the envelope window.  If you 
  983. begin this operation from the Net Addr field or field label in the Address Book 
  984. window, the mouse pointer will instead read NET and the data will be placed 
  985. into the Net: field in the envelope window.  If you begin from anywhere else in 
  986. in the Address Book window other than directly over the above mentioned fields 
  987. or their labels, the mouse pointer will appear as two rectangles, NAME and NET, 
  988. and the data will go to both fields in the Envelope window.  To cancel the drag 
  989. and drop operation, simply release the mouse button anywhere where it DOES have 
  990. the circle-slash visible. 
  991.  
  992. There is no corresponding drag and drop mechanism for copying data from the 
  993. Envelope into the Address Book in this release of PmQwk. You may, of course, 
  994. use the system clipboard to accomplish this as outlined above. 
  995.  
  996.  
  997. ΓòÉΓòÉΓòÉ 11. Setting Options ΓòÉΓòÉΓòÉ
  998.  
  999. Select Options from the menu bar to do any of the following: 
  1000.  
  1001.   1. Fonts 
  1002.   2. Colors 
  1003.   3. Paths 
  1004.   4. Editor 
  1005.   5. Preferences 
  1006.   6. Save Options 
  1007.  
  1008.  
  1009. ΓòÉΓòÉΓòÉ 11.1. Changing Fonts ΓòÉΓòÉΓòÉ
  1010.  
  1011. This dialog allows you to set the fonts which PmQwk will use for message 
  1012. displays and list boxes. 
  1013.  
  1014. Select Options from the menu bar, then Fonts, then either Messages... or List 
  1015. Boxes... to open a standard font dialog. 
  1016.  
  1017. Press Apply to immediately see the result of your font choice in your PmQwk 
  1018. windows without leaving the font dialog.  Press Ok to apply the font to your 
  1019. PmQwk windows and dismiss the font dialog. 
  1020.  
  1021.  
  1022. ΓòÉΓòÉΓòÉ 11.2. Changing Colors ΓòÉΓòÉΓòÉ
  1023.  
  1024. Select Options from the menu bar, then Colors, to open a dialog which will 
  1025. allow you to change the colors withing PmQwk for message displays and list 
  1026. boxes. 
  1027.  
  1028. Note:  In this BETA release of PMQWK, entries appear for "Message HiLited Text" 
  1029. and "Message HiLited Text Background".  These setting are NOT functional in 
  1030. this release, the highlighted colors in message displays are a function of the 
  1031. normal, non-hilighted colors. 
  1032.  
  1033.  
  1034. ΓòÉΓòÉΓòÉ 11.3. Selecting Paths ΓòÉΓòÉΓòÉ
  1035.  
  1036. Set various paths for PmQwk: 
  1037.  
  1038.  o Inbound QWK Packets 
  1039.  o Outbound Reply Packets 
  1040.  o Packers and Unpackers 
  1041.  
  1042.  
  1043. ΓòÉΓòÉΓòÉ 11.3.1. Inbound QWK Packets ΓòÉΓòÉΓòÉ
  1044.  
  1045. Set this item to the name of the directory in which new QWK packets will appear 
  1046. after they have been downloaded from the BBS or on-line services.  In general, 
  1047. this will be the download directory which your telecommunications program uses 
  1048. although you may wish to create a new directory specifically for this purpose 
  1049. and move QWK packets into this directory by other means after they have been 
  1050. downloaded. 
  1051.  
  1052. Note:  In this version of PmQwk the validity of this path is NOT checked at 
  1053. this point. 
  1054.  
  1055.  
  1056. ΓòÉΓòÉΓòÉ 11.3.2. Outbound Reply Packets ΓòÉΓòÉΓòÉ
  1057.  
  1058. Set this item to the name of the directory where you wish PmQwk to deposit 
  1059. packaged reply packets to be uploaded back to the BBS or on-line service. In 
  1060. general, this will be a directory in which your telecommunications program 
  1061. expects to find files for upload. 
  1062.  
  1063. Note:  In this version of PmQwk the validity of this path is NOT checked at 
  1064. this point. 
  1065.  
  1066.  
  1067. ΓòÉΓòÉΓòÉ 11.3.3. Packers and Unpackers ΓòÉΓòÉΓòÉ
  1068.  
  1069. Fill in as many of these as are applicable with the drive, path, and name of 
  1070. the appropriate archiving program or programs.  If they exist in a directory 
  1071. referred to in your PATH environment variable, you may omit the drive and path 
  1072. specification and give only the name of the program file. 
  1073.  
  1074. Note:  In this version of PmQwk, these programs names and paths are NOT checked 
  1075. for validity at this point. FURTHER NOTE: in this version of PmQwk, only the 
  1076. first three archivers are supported: PK(UN)ZIP, ARC, and LH.  Entries exist for 
  1077. ARJ and ZOO for future use only, they are not used by this version of PmQwk. 
  1078.  
  1079.  
  1080. ΓòÉΓòÉΓòÉ 11.4. Setting Editor ΓòÉΓòÉΓòÉ
  1081.  
  1082. You may select your editor of choice  for purposes of editing reply messages by 
  1083. selecting the menuitem Editors under the menu bar item Options 
  1084.  
  1085. Type the name of the editor in the indicated field, if the program file is not 
  1086. in a directory referred to in your PATH environment variable, you must include 
  1087. the entire drive and path specification for the program.  Once you have 
  1088. specified a valid program name here you will be given the opportunity to select 
  1089. how the program will be executed, i.e., as a Presentation Manager program, in a 
  1090. full screen session, or in a windowed session.  Both OS/2 and D.O.S. based 
  1091. editors are supported. 
  1092.  
  1093. The default editor for PmQwk is E.EXE, the OS/2 system editor. 
  1094.  
  1095. Note:  Certain editors will cause problems with PmQwk.  The OS/2 Enhanced 
  1096. Editor (EPM.EXE) will work correctly with PmQwk if and only if there are no 
  1097. other copies of EPM running on your machine at the time you begin an edit 
  1098. session via PmQwk (this includes other PmQwk edit sessions).  The IBM IUO 
  1099. editor, LXPM, does not function correctly for use with PmQwk. 
  1100.  
  1101.  
  1102. ΓòÉΓòÉΓòÉ 11.5. Setting Preferences ΓòÉΓòÉΓòÉ
  1103.  
  1104. Preferences is a catchall for a number of semi-related settings.  Select any of 
  1105. the following for more information: 
  1106.  
  1107.  o Beep on personal messages 
  1108.  o Show only active conferences 
  1109.  o Attribute Quotes 
  1110.  o Wrap Column for Quotes 
  1111.  o Prepend "Re:" to response subject lines 
  1112.  o Strip existing "Re:" from subject lines 
  1113.  o Prev/Next buttons on right in message reader 
  1114.  o Use Taglines 
  1115.  o Use PmQwk Cutline 
  1116.  
  1117.  
  1118. ΓòÉΓòÉΓòÉ 11.5.1. Beep on personal messages ΓòÉΓòÉΓòÉ
  1119.  
  1120. If this setting is checked, PmQwk will alert you with a tone whenever you view 
  1121. a message addressed to you. 
  1122.  
  1123.  
  1124. ΓòÉΓòÉΓòÉ 11.5.2. Show only active conferences ΓòÉΓòÉΓòÉ
  1125.  
  1126. If this option is set ON (the default), PmQwk will only display those 
  1127. conference names belonging to conferences containing more than zero messages in 
  1128. the "Conference List" dialog.  Use this setting if you have a large number of 
  1129. empty conferences listed by a BBS and you do not wish to navigate past them to 
  1130. find the active areas. 
  1131.  
  1132.  
  1133. ΓòÉΓòÉΓòÉ 11.5.3. Attribute quotes ΓòÉΓòÉΓòÉ
  1134.  
  1135. If this setting is checked, you specify that you want PmQwk to provide an 
  1136. "Attribution" to the quotes in your reply messages and you may further specify 
  1137. how you wish this Attribution to appear. 
  1138.  
  1139. Type any text you wish into the associated entry field and it will be echoed 
  1140. into your reply messages.  There are several special character sequences which 
  1141. you may embed into this text which will cause PmQwk to insert relevant 
  1142. information from the message header: 
  1143.  
  1144.  o %s inserts the SENDER's name from the original message 
  1145.  
  1146.  o %r inserts the RECEIVER's name from the original message 
  1147.  
  1148.  o %j inserts the SUBJECT of the original message 
  1149.  
  1150.  o %d inserts the DATE of the original message 
  1151.  
  1152.  o %t inserts the TIME of the original message 
  1153.  
  1154.  o %_ inserts a line break in the attribution string 
  1155.  
  1156.  o %% is used to insert a '%' character in the string. 
  1157.  
  1158.  Please note, these codes ARE case sensitive!  "%S" will NOT work like "%s", 
  1159.  instead it will simply insert the characters "%S" into the attribution string. 
  1160.  
  1161.  
  1162. ΓòÉΓòÉΓòÉ 11.5.4. Wrap Column for Quotes ΓòÉΓòÉΓòÉ
  1163.  
  1164. The column at which lines will be broken for purposes of quoting original 
  1165. messages.  PmQwk attempts to be intelligent about word boundaries and will try 
  1166. to wrap lines at word breaks. 
  1167.  
  1168. Because messages are reformatted based on your setting for "Wrap Column" both 
  1169. when quoting a message before a reply and when importing your message from the 
  1170. editor back into PmQwk, you should be aware of the algorithm used for message 
  1171. formatting so that you can achieve a pleasing result. 
  1172.  
  1173. The message formatter is paragraph based.  It assumes that a new paragraph has 
  1174. started when it encounters either a blank line or an indented line.  It will 
  1175. pull the entire paragraph together to make a "best fit" within your defined 
  1176. wrap column.  For example, assuming you have the (unlikely) wrap setting of 30, 
  1177. the following text: 
  1178.  
  1179.     |---|----|----|----|----|----|
  1180.      Now is the time for all good men to
  1181.      come to the aid
  1182.      of their country.
  1183.  
  1184.  would be reformatted as: 
  1185.  
  1186.     |---|----|----|----|----|----|
  1187.      Now is the time for all good
  1188.      men to come to the aid of
  1189.      their country.
  1190.  
  1191.  While the following: 
  1192.  
  1193.     |---|----|----|----|----|----|
  1194.       Table data:
  1195.       Column 1       Column 2
  1196.       --------       --------
  1197.       Apples         Oranges
  1198.  
  1199.  would not be reformatted at all because of the indentation.  If you are not 
  1200.  aware of the way this behaves, you may end up with undesirable results.  For 
  1201.  instance, if you entered the following: 
  1202.  
  1203.     |---|----|----|----|----|----|
  1204.      Hello Joe!
  1205.      Whatcha know?
  1206.      I just got back from Kokomo!
  1207.      Yours truly,
  1208.      Ira
  1209.  
  1210.  it would end up looking like: 
  1211.  
  1212.     |---|----|----|----|----|----|
  1213.      Hello Joe! Whatcha know? I
  1214.      just got back from Kokomo!
  1215.      Yours truly, Ira
  1216.  
  1217.  Use blank lines and indentation to avoid having lines pulled back for you when 
  1218.  you don't want this to happen. 
  1219.  
  1220.  
  1221. ΓòÉΓòÉΓòÉ 11.5.5. Prepend "Re:" to response subject lines ΓòÉΓòÉΓòÉ
  1222.  
  1223. Automatically place the characters "Re:" at the beginning of subjects lines in 
  1224. replies.  "Re:" will NOT be prepended if those characters are already present 
  1225. at the beginning of the subject. 
  1226.  
  1227.  
  1228. ΓòÉΓòÉΓòÉ 11.5.6. Strip existing "Re:" from subject lines ΓòÉΓòÉΓòÉ
  1229.  
  1230. Remove the characters "Re:" and any white space following from subject lines in 
  1231. replies.  Note that this option and the Prepend option are NOT mutually 
  1232. exclusive!  If they are both checked, subject lines in replies will always 
  1233. contain one and only one "Re:" if neither is checked, no subject line is ever 
  1234. altered by PmQwk. 
  1235.  
  1236. Note further that you have the ability to add or remove any characters you wish 
  1237. from a subject line via the "Envelope" dialog; these setting are provided as a 
  1238. convenience. 
  1239.  
  1240.  
  1241. ΓòÉΓòÉΓòÉ 11.5.7. Prev/Next buttons ΓòÉΓòÉΓòÉ
  1242.  
  1243. You may prefer it if the "Next" and "Prev" buttons appeared on the right side 
  1244. of the message reader window and closer to the scroll bars which govern the 
  1245. message text.  If so, set this option ON. Be warned, however, that if you move 
  1246. the focus in this window using the TAB or arrows keys that the focus will 
  1247. appear to move out of order with respect to these buttons! 
  1248.  
  1249.  
  1250. ΓòÉΓòÉΓòÉ 11.5.8. Use Taglines ΓòÉΓòÉΓòÉ
  1251.  
  1252. If this option is checked, PmQwk will look in the same directory that contains 
  1253. the PMQWK.EXE file for a file named "TagLines.txt". If it is found it will use 
  1254. this for its source of tag lines (humorous or provocative short quotes which 
  1255. will be appended to your outgoing messages) and the "TagLine" drop-down list 
  1256. will be enabled in the various "Envelope" dialogs.  From there you may select a 
  1257. line from the list, type in a fresh one "on the fly", or erase it entirely. 
  1258.  
  1259. The TagLines.txt file is a flat ASCII file containing one tagline per line of 
  1260. file; you may edit this file with any text editor. Taglines should not be 
  1261. longer than about 60 or 70 characters. 
  1262.  
  1263.  
  1264. ΓòÉΓòÉΓòÉ 11.5.9. Use PmQwk Cutline ΓòÉΓòÉΓòÉ
  1265.  
  1266. If this option is set OFF then PmQwk will not append it's own "signature line" 
  1267. to your outgoing messages. 
  1268.  
  1269.  
  1270. ΓòÉΓòÉΓòÉ 11.6. Saving Options ΓòÉΓòÉΓòÉ
  1271.  
  1272. All options discussed in the Preferences section may be saved semi-permanently 
  1273. in an initialization file by selecting this option.  You may always change an 
  1274. option again and resave it. 
  1275.  
  1276. If you change options and do not select "Save options" before you attempt to 
  1277. exit PmQwk, you will be alerted to this fact and given the opportunity to do so 
  1278. at that point. 
  1279.  
  1280. Options are saved in a file named PMQWK.INI in the same directory as PMQWK.EXE. 
  1281. If you've really made a mess of your settings and wish to "start from scratch" 
  1282. just delete this file while PmQwk is not running and restart the program. 
  1283.  
  1284. Warning: If you have used an earlier (16-bit) beta version of PmQwk, you MUST 
  1285. delete your PMQWK.INI file before running this version and then use the current 
  1286. version to reset your options. 
  1287.  
  1288.  
  1289. ΓòÉΓòÉΓòÉ 12. Message Envelope ΓòÉΓòÉΓòÉ
  1290.  
  1291. When you finish editing your reply, you will be returned to PmQwk and given the 
  1292. opportunity to edit the "Envelope" information.  This will already have your 
  1293. name, the receivers name, net address (if applicable), the conference for the 
  1294. message, and the subject filled in.  You may edit any of these items except 
  1295. your own name.  If TagLines are enabled you may select a tagline to use from 
  1296. this dialog. 
  1297.  
  1298. If you press "OK" and all of the required fields are filled in, the reply will 
  1299. be saved.  If you press "Cancel" the message will be discarded after you 
  1300. confirm that this is your desire. 
  1301.  
  1302.  
  1303. ΓòÉΓòÉΓòÉ 13. Setting Icons for Confs and BBSs ΓòÉΓòÉΓòÉ
  1304.  
  1305. Though not on any menu within this version of PmQwk, you may specify your own 
  1306. custom icons and attach them to any "BBS Conference List" dialog or to any 
  1307. "Conference" dialog.  You must use OS/2 version 1.3 compatible color or black 
  1308. and white icon files (.ICO).  To do this, create a directory underneath the 
  1309. directory containing PMQWK.EXE named "PMQIcons" and place all of your custom 
  1310. icon files in this directory.  PmQwk will determine how to use these icons by 
  1311. the names you give the files: 
  1312.  
  1313.  o To attach an icon to a BBS (Conference List Dialog) give the icon file the 
  1314.    same "first name" as the BBS id and an extension of .ICO.  (Example: A BBS 
  1315.    id might be "FERNWOOD", name the icon file "FERNWOOD.ICO"). 
  1316.  
  1317.  o To attach an icon to a specific conference for a specific BBS, use the same 
  1318.    first name as above but give the file an extension which is the conference 
  1319.    number, left padded to three characters with zeros (Example: to attach an 
  1320.    icon to conference #5 for the "FERNWOOD" BBS, name the icon file 
  1321.    "FERNWOOD.005"). 
  1322.  
  1323.  o To attach an icon to the "Personal Messages" conference, do as above but 
  1324.    give the icon file the extension ".PER".  To attach it to the "Replies" 
  1325.    pseudo-conference, give it the extension ".ANS". 
  1326.  
  1327.  Note:  This procedure will be built into the program and made more easy for 
  1328.  the average user in the future.  Do not attempt this procedure if the above 
  1329.  discussion made little or no sense to you! 
  1330.  
  1331.  
  1332. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  1333.  
  1334.  Oberon Software 
  1335.  518 Blue Earth Street 
  1336.  Mankato, MN 56001-2142 USA 
  1337.  Phone: 507-388-7001 
  1338.  FAX: 507-388-7568 
  1339.  BBS: 507-388-1154 
  1340.  CompuServe: 72510,3500 
  1341.  GEnie: B.FLOWERS 
  1342.  MCI Mail: oberon/413-5847 
  1343.  
  1344.  
  1345. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  1346.  
  1347.  Fidonet netmail: Kimberly Bobrow @ 1:141/261 
  1348.  Internet address: Kimberly.Bobrow@hnews.fidonet.org 
  1349.  OS/2 Shareware BBS ID: Kimberly Bobrow 
  1350.  Oberon Software BBS ID: Kimberly Bobrow 
  1351.  Voice message: (212) 465-3367 [USA] 
  1352.  
  1353.  
  1354. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  1355.  
  1356. Please note that the '\t' used in the example to imply a TAB character is there 
  1357. for illustration only because an actual TAB character is difficult to display 
  1358. within the context of the IPF.  The C-style backslash notation for tabs, 
  1359. newlines, etc. is NOT supported by this regular exression engine. Because of 
  1360. the '^' and '$' metacharacters and the fact that matches cannot occur across 
  1361. line boundaries, the loss of '\n' and '\r' should be no hardship.  If you need 
  1362. to specify a TAB, you may simply enter an actual TAB character.